.. _cmmOverrideMoveTo:

cmmOverrideMoveTo
=====================
---------------------


SYNOPSIS
`````````````

.. code-block::

    VT_I4 cmmOverrideMoveTo(
        [in] VT_I4 Axis, [in] VT_R8 NewPosition, [out] VT_PI4 IsIgnored
        )


DESCRIPTION
`````````````

- 이 함수는 cmmSxMoveToStart() 함수를 통하여 수행되는 절대좌표 In-position 모션에 대하여 목표 절대좌표값을
  오버라이딩하는 함수입니다.

PARAMETER
```````````

- Axis: 축번호. 축번호는 상수값으로 [cmX1] 부터 0 번째 축을 기준 축으로 임의의 축을 설정할 수 있습니다.

\

- NewPosition : 새로운 목표 절대좌표값을 지정합니다. 

\

- IsIgnored : cmmOverrideMoveTo 의 적용 성공/실패 여부를 반환 합니다.

.. csv-table::
    :widths: 10 85
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    0 , 성공. 위치 오버라이드가 적용됨
    1 , 실패. 모션에러가 발생하였거나 이미 이송이 완료되어 위치 오버라이드가 적용되지 않음.


RETURN VALUE
`````````````

+--------------+-----------+
| Value        | Meaning   |
+==============+===========+
| 음수         | 수행 실패 |
+--------------+-----------+
| cmERR_NONE   | 수행 성공 |
+--------------+-----------+


REFERENCE
```````````

-  위치 오버라이드를 수행하려는 시점에 이미 이송이 완료되어 버린 경우에는 위치 오버라이드는 무시되고 Ignored 
   파라미터 값을 1 로 반환합니다. 따라서 사용자는 Ignored 파라미터 값이 1 인 경우에는 이미 이송이 완료되어
   오버라이드가 적용되지 않은 것으로 인지하여야 하며, 그럼에도 불구하고 목표좌표를 수정해야하는 경우에는
   cmmSxMoveTo() 함수를 추가적으로 수행해야합니다.